DVItoVDU v3.3 24 April 1990 ~~~~~~~~~~~~~ 1. INTRODUCTION ~~~~~~~~~~~~~~~~ This directory tree contains the files needed to upgrade Trevorrow's DVItoVDU v3.1 to v3.3. The changes made BETWEEN V3.1 AND V3.3 are detailed in the file 00CHANGES.TXT. The files provided are: ----------------------------------------------------------------------------- 00README.TXT - this file 00CHANGES.TXT - details of the changes made between v3.1 and v3.3 DVITOVDU.CLD - the command verb definition file for DVItoVDU DVITOVDU_ONLINE.HLP - the file used by DVItoVDU to provide online help DVITOVDU_DCL.HLP - a help file suitable for inclusion in a DCL help library RMCS_USERGUIDE.TEX - the DVItoVDU user guide prepared at RMCS SRC.DIR - a subdirectory containing the new / changed .DEF & .MOD source modules. For users of DEC's module management system (MMS), there is a DESCRIP.MMS file for building DVItoVDU. In addition, compiler .OBJ and .SYM files have been placed in the directory [TeX-Archive.Binary.DVItoVDU]; these were generated using V4.1-0 of the Modula-2 compiler supplied by Logitech. For those without this compiler, a linked executable DVItoVDU.EXE is also provided in this directory; this has been linked against Logitech's run-time library, so will run on VMS V5.1 and later, even when the shareable image for that library is not available. ----------------------------------------------------------------------------- 2. INSTALLING DVItoVDU ~~~~~~~~~~~~~~~~~~~~~~~ The files needed to install DVItoVDU v3.3 are: DVITOVDU.CLD DVITOVDU.EXE DVITOVDU_ONLINE.HLP The image DVITOVDU.EXE is provided, though you can build it from the sources (see section 4.) The DVItoVDU.CLD file defines the DVItoVDU command verb. You will need to edit several items to suit your system setup (notably the IMAGE line and the default values of the /HELP_FILE, /PK_FONT_DIRECTORY & /PXL_FONT_DIRECTORY qualifiers). Once you've copied the above files to the chosen locations, DVItoVDU v3.3 is ready to use. 3. INSTALLING DVItoVDU ~~~~~~~~~~~~~~~~~~~~~~~ Some documentation is provided, namely a user guide and a help file suitable for online DCL help. To add DCL help for DVItoVDU to (for example) the main help library, use a command like: LIBRARY/LOG/HELP/REPLACE SYS$HELP:HELPLIB.HLB DVITOVDU_DCL.HLP The userguide is in LaTeX source format, and can be processed ready for use by your DVI-to-?? driver with the commands: LATEX rmcs_userguide LATEX rmcs_userguide 4. BUILDING DVItoVDU FROM SOURCES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ You'll need a MODULA-2 compiler to build DVItoVDU from sources. Assuming that you already have the sources for DVItoVDU v3.0, you should COPY in the files provided in the [.SRC] subdirectory. This will replace some of the existing files and insert some new ones. If you are fortunate to have DEC's Module Management System (MMS), the supplied DESCRIP.MMS file will do most of the work for you. If you don't have MMS, the command file BUILD_DVITOVDU.COM may help. Before compiling, check the 00CHANGES.TXT file as some of the changes made may not be supported by your compiler. If you do manage to produce a working DVItoVDU, please let us know - we'd like to support as many compilers as possible. 5. CONTACT ADDRESS ~~~~~~~~~~~~~~~~~~~ Most of the changes were made at RMCS, with some of VDU modules and ideas contributed Phil Taylor of RHBNC . Suggestions and/or constructive criticisms are welcome! Please post them to: Niel Kempson .-------------------------------------------------------------------------. | JANET: tex@uk.ac.cranfield.rmcs | | BITNET: tex%uk.ac.cranfield.rmcs@ukacrl | | INTERNET: tex%uk.ac.cranfield.rmcs@nsfnet-relay.ac.uk | | Smail: School of Electrical Engineering & Science, Royal Military | | College of Science, Shrivenham, SWINDON SN6 8LA, U.K. | | Phone: Swindon (0793) 785687 (UK), +44-793-785687 (International) | `-------------------------------------------------------------------------'